home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / editor / htmst610.zip / MOZ.DOC < prev    next >
Text File  |  1996-10-19  |  9KB  |  195 lines

  1. MOZ.DOC                              1                         Revised: 10-18-96
  2.  
  3. The MOZ program processes your Netscape Web cache, renaming or copying files  so
  4. their file names correspond to the original names they had  on  the  originating
  5. site.  Features of this program:
  6.  
  7.   * Renames or copies all of the files in the cache.
  8.   * Should work for the caches from version 2.0 of Netscape.
  9.   * Originally was written to handle Mosaic caches version 2.0 or above although
  10.     I don't use Mosaic anymore so I have no idea if it still works.  Someone
  11.     told me it didn't work with the Spry version.  Sorry!
  12.   * Renames each file (with file names like M0OSOSFD.GIF) to match their
  13.     original names on the originating site as closely as possible (so this
  14.     file might end up being BATMAN.GIF).
  15.   * If there are files with duplicate source names, it renames according to
  16.     a sequential system (BATMAN01.GIF, BATMAN02.GIF, etc).
  17.   * Reads each of the files in the cache and determines the file type.
  18.     File types can be any of the following:
  19.       AU  (sound files)
  20.       BMP (graphic files)
  21.       EXE (compiled programs)
  22.       GIF (graphic files)
  23.       HTM (HTML files)
  24.       JPG (graphic files)
  25.       MID (sound files)
  26.       WAV (sound files)
  27.       ZIP (compressed files)
  28.     Renames the file extension according to the file type.
  29.   * Files marked read-only, system, or hidden are ignored during renaming.
  30.   * When the /RENAME option is used, a fail-safe file called C:\MOZBACK.BAT
  31.     is, by default, created which contains all of the RENAME commands
  32.     necessary to rename everything back the way it was.
  33.   * Can be used to create an HTML file linked to all of the GIF and JPG
  34.     files in the subdirectory.  In Netscape, you would then use File | Open
  35.     File to load this HTML page and then you would see all of the graphics
  36.     in your cache full size and they would be identified on the screen.
  37.  
  38.  
  39. Note:  You should not run this command while your Web browser is running  as  it
  40. won't be able to open the necessary cache management file.
  41.  
  42.  
  43. Specifying parameters:
  44.  
  45. Parameters for this program can be set in the following ways.  The last  setting
  46. encountered always wins:
  47.   - Read from an *.INI file (see BRUCEINI.DOC file),
  48.   - Through the use of an environmental variable (SET MOZ=whatever), or
  49.   - From the command line (see "Syntax" below)
  50.  
  51.  
  52.  
  53. MOZ.DOC                              2                         Revised: 10-18-96
  54.  
  55. Syntax:
  56.  
  57.     MOZ [ path | /Cpath ] { /COPY=path | /RENAME | /SKIP } [ /ALL ]
  58.       [ /-MOZBACK | /MOZBACK | /MOZBACK=filename ]
  59.       [ /-SLIDE | /SLIDE | /SLIDE=filename ]
  60.       [ /OVERWRITE | /-OVERWRITE | /OVERASK ]
  61.       [ /MONO ] [ /DEBUG ] [ /Iinitfile | /-I ] [ /? ]
  62.  
  63. where:
  64.  
  65. "path" (or "/Cpath") is where the files are found.  If no path is provided,  the
  66. program defaults to looking in the following locations in sequence:
  67.  
  68.         default subdirectory
  69.         C:\NETSCAPE\CACHE
  70.         C:\MOSAIC\CACHE
  71.         D:\NETSCAPE\CACHE
  72.         D:\MOSAIC\CACHE
  73.  
  74. The  first  subdirectory  that  exists  and  contains  any  files  meeting   the
  75. specification *.MO* or M0*.* will be the one processed by the command.
  76.  
  77. "/COPY=path" specifies that the processed files are to be copied under their new
  78. names to  the  specified  output  subdirectory,  not  renamed  in  the  existing
  79. subdirectory.  If no subdirectory is specified (i.e.   just  "/COPY"  is  passed
  80. in), you will be prompted for one.  If the subdirectory does not exist  already,
  81. you will be prompted for whether to create it or not.
  82.  
  83. "/RENAME" specifies that the files are to be renamed instead  of  copied.   This
  84. works great unless you specify it by mistake.  Even then, the /MOZBACK file will
  85. allow you to backtrack although the MOZBACK file gets wiped out the second  time
  86. through.
  87.  
  88. "/SKIP" doesn't bother doing any renaming  or  copying  with  the  files.   It's
  89. mainly used when you want the program to create an HTML page with  the  relevant
  90. graphics.
  91.  
  92. "/ALL" renames all files in  the  cache,  whether  they're  in  the  Web-created
  93. directory file (e.g.  FAT.DB) or not.  Note that if your Web browser  GPF'ed  or
  94. something nasty while you were running it, the FAT.DB file will be incomplete or
  95. even missing.  /FINAL allows the orphan files to be processed  somewhat.   Files
  96. matching either *.MO* (Mosaic's default filter)  or  M0*.*  (Netscape's  default
  97. filter) will be renamed sequentially starting with _000.* if /ALL is  specified.
  98. Initially, the default is "/-ALL".
  99.  
  100. "/-ALL" skips processing files that aren't identified in  the  cache  directory.
  101. This is initially the default.
  102.  
  103.  
  104. MOZ.DOC                              3                         Revised: 10-18-96
  105.  
  106. "/-MOZBACK" skips creating a back-out file.  The back-out batch file,  available
  107. only when /RENAME is in effect, consists of a series  of  RENAME  commands  that
  108. reverses the changes that were just made.  The initial default is "/MOZBACK".
  109.  
  110. "/MOZBACK" creates the back-out file as C:\MOZBACK.BAT and is the same thing  as
  111. specifying /MOZBACK=C:\MOZBACK.BAT.  This file is only  created  if  /RENAME  is
  112. used.  This is initially the default.
  113.  
  114. "/MOZBACK=filename" creates the  back-out  file  under  the  specified  filename
  115. instead of using the default filename C:\MOZBACK.BAT.  This file is only created
  116. if /RENAME is used.  If the  filename  exists  already,  you  will  prompted  to
  117. overwrite it or not depending on  the  value  of  /OVERWRITE,  /-OVERWRITE,  and
  118. /OVERASK.
  119.  
  120. "/-SLIDE" skips creating an HTML file that loads each of the GIF or JPEG graphic
  121. files in the given cache directory.  This is initially the default.
  122.  
  123. "/SLIDE" creates an HTML file named C:\MOZ.HTM which consists  of  a  series  of
  124. <IMG SRC=filename> specifications for each of the GIF or JPEG graphic  files  in
  125. the given cache directory.  When you view this file using File |  Open  File  in
  126. Netscape (or a similar command in other browsers), all of the graphic files will
  127. be loaded onto your screen for you to  view.   "/SLIDE"  is  the  same  entering
  128. "/SLIDE=C:\MOZ.HTM".  You  can  have  the  program  do  a  slide  show  for  all
  129. GIF/JPEG's in your subdirectory (whether they were part of the cache or not)  by
  130. saying:
  131. MOZ subdir /SLIDE /ALL /SKIP where "subdir" is where those files are saved.
  132.  
  133. "/SLIDE=filename" creates the HTML file under the specified filename instead  of
  134. using the default filename C:\MOZ.HTM.  If the filename exists already, you will
  135. prompted  to  overwrite  it  or  not  depending  on  the  value  of  /OVERWRITE,
  136. /-OVERWRITE, and /OVERASK.
  137.  
  138. "/OVERWRITE" says that if either of the output files exist already (depending on
  139. the value of /SLIDE and /MOZBACK), don't prompt before overwriting it.
  140.  
  141. "/-OVERWRITE" says to abort if either of the output files exist already.
  142.  
  143. "/OVERASK" says to prompt if either of the output files exist already.  This  is
  144. initially the default.
  145.  
  146. "/MONO" (or "/-COLOR") does  not  try  to  override  screen  colors.   Initially
  147. defaults to "/COLOR".
  148.  
  149. "/COLOR" (or "/-MONO") allows screen colors to be overridden.  This is initially
  150. the default.
  151.  
  152. "/DEBUG" tells you what it would  rename  everything  but  doesn't  actually  do
  153. anything.
  154.  
  155. "/Iinitfile" says to read an initialization file with the file name  "initfile".
  156. The file specification *must* contain a period.  Initfiles are described in  the
  157. BRUCEINI.DOC file.  Initially defaults to "/IMOZ.INI".
  158.  
  159. "/-I" (or "/INULL") says to skip loading the initialization file.
  160.  
  161.  
  162.  
  163. MOZ.DOC                              4                         Revised: 10-18-96
  164.  
  165. Author:
  166.  
  167. This program was written by Bruce Guthrie of Wayne Software.  It is free for use
  168. and redistribution provided relevant documentation is kept with the program,  no
  169. changes are made to the program or documentation, and it  is  not  bundled  with
  170. commercial programs or charged for separately.  People who need to bundle it  in
  171. for-sale packages must pay a $50 registration fee to  "Wayne  Software"  at  the
  172. following address.
  173.  
  174. Additional information about this and other Wayne Software programs can be found
  175. in the file BRUCEymm.DOC which should be included  in  the  original  ZIP  file.
  176. ("ymm" is replaced by the last digit of the year and the two digit month of  the
  177. release.  BRUCE606.DOC came out in June 1996.  This same  naming  convention  is
  178. used in naming the ZIP file that this program was  included  in.)  Comments  and
  179. suggestions can also be sent to:
  180.  
  181.                 Bruce Guthrie
  182.                 Wayne Software
  183.                 113 Sheffield St.
  184.                 Silver Spring, MD 20910
  185.  
  186.                 fax: (301) 588-8986
  187.                 e-mail: bguthrie@nmaa.org
  188.                 http://hjs.geol.uib.no/guthrie/
  189.  
  190. See BRUCEymm.DOC file for revision history.
  191.  
  192. Please provide an Internet e-mail address on all correspondence.
  193.  
  194. 
  195.